交叉编译工具链¶

概述¶

交叉编译工具链是在主机（如x86_64架构的Ubuntu）上编译目标设备（如ARM架构的Quectel Pi H1）程序的必备工具。本文档介绍如何获取和部署Quectel Pi H1的交叉编译工具链。

系统要求¶

操作系统：Ubuntu 22.04（推荐）
架构：x86_64
磁盘空间：至少5 GB可用空间

下载工具链¶

下载地址¶

点击下载：qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip

工具链信息¶

平台：Qualcomm QCM6490
架构：ARMv8-2a
图形系统：Wayland
版本：1.3-ver.1.1

部署工具链¶

解压安装包¶

下载完成后，解压ZIP文件：

unzip qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.zip

执行安装脚本¶

给安装脚本添加可执行权限并运行：

chmod +x qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh
./qcom-wayland-x86_64-qcom-multimedia-image-armv8-2a-qcm6490-idp-toolchain-1.3-ver.1.1.sh

选择安装目录¶

执行脚本后，系统会提示输入安装目录：

默认目录：直接按Enter键使用默认路径
自定义目录：输入您想要的安装路径

安装完成后，脚本会提示SDK环境的使能方式。

部署示例¶

../../../_images/image_Zf61bG8xZoZclQxcrNJc7TICnif.webp

使用工具链¶

环境变量配置¶

部署完成后，需要在使用前配置环境变量。通常可以通过以下命令激活SDK环境：

source <安装目录>/environment-setup-armv8-2a-qcom-linux

提示：将 <安装目录> 替换为您实际的安装路径。

验证安装¶

可以通过以下命令验证工具链是否正确安装：

$CC --version

如果显示交叉编译器的版本信息，说明工具链已成功部署。

常见问题¶

Q1: 安装脚本执行失败？¶

解决方法：

确保脚本具有可执行权限
检查磁盘空间是否充足
确认系统版本为Ubuntu 22.04

Q2: 环境变量配置后无效？¶

解决方法：

确认 source 命令执行成功
检查安装目录路径是否正确
尝试在新的终端窗口中重新执行 source 命令

Q3: 如何让环境变量永久生效？¶

解决方法：

可以将 source 命令添加到 ~/.bashrc 文件中：

echo "source <安装目录>/environment-setup-armv8-2a-qcom-linux" >> ~/.bashrc
source ~/.bashrc

下一步¶

成功部署交叉编译工具链后，您可以：

进行内核模块开发
编译设备驱动程序
构建应用程序

更多开发相关信息，请参考对应的开发文档。